STM32入门：基于GPIO的输出控制

GPIO 即 通用型输入输出端口（General-Purose Input / Output）的简称，简单来说就是 STM32 单片机的可控制的引脚，功能类似于 8051 系列单片机的 P0-P3 端口。STM32 芯片的 GPIO 引脚与外部设备连接起来，从而实现与外部的通讯、控制以及数据采集的功能。STM32 芯片的 GPIO 被分为很多组，每组 16 个引脚，例如型号为 STM32F103VET6 型号的芯片有 GPIOA、GPIOB 至 GPIOE 一共 5 组 GPIO ，芯片一共有 100 个引脚，其中 GPIO 就占了很大一部分，所有的 GPIO 引脚都具有基本的输入输出功能。

最基本的输出功能是由 STM32 控制引脚输出高、底电平，实现开关控制，例如把 GPIO 引脚接入到 LED 灯上，就可以用来控制 LED 灯的亮灭，引脚接入到继电器或者三极管，那就可以通过继电器或者三极管来控制外部大功率电路的推断，实现电气隔离。

最基本的输入功能是检测外部输入的电平，如把 GPIO 引脚连接到轻触按键上，通过引脚电平的高低来区分按键是否按下。

STM32 芯片 GPIO 接口内部原理如下：

通过 GPIO 硬件结构图，就可以从整体上深入的了解 GPIO 外设以及它的各种应用模式。从图的最右端看，最右端代表的是 STM32 芯片引出的 GPIO 引脚，其余部件都位于芯片内部。

引脚上的两个保护二级管用于防止引脚外部过高或过低的电压输入，当引脚电压高于 Vdd 时,上方的二极管导通，当引脚电压低于 Vss 时，下方的二极管导通，防止不正常电压引入芯片导致芯片烧毁。

尽管有这样的保护，并不意味着 STM32 的引脚能直接外接大功率驱动器件，如直接驱动电机，强制驱动要么电机不转，要么导致芯片烧坏，必须要加大功率及隔离电路驱动。

GPIO引脚线路经过两个保护二极管后,向上流向“输入模式”结构,向下流向“输出模式”结构。先看输出模式部分,线路经过一个由 P-MOS 和 N-MOS 管组成的单元电路。这个结构使 GPIO 具有了“推挽输出”和“开漏输出”两种模式。

所谓的推挽输出模式,是根据这两个 MOS 管的工作方式来命名的。在该结构中输人高电平时，经过反向后，上方的 P-MOS 导通，下方的 N-MOS 关闭,对外输出高电平，即“推”；而在该结构中输入低电平时，经过反向后， N-MOS 管导通，P-MOS 关闭，对外输出低电平，即“挽”。当引脚高低电平切换时，两个管子轮流导通，P 管负责灌电流，N管负责拉电流，使其负载能力和开关速度都比普通的方式有很大的提高。推挽输出的低电平为0伏，高电平为3.3伏。推挽模式的等效电路如下：

而在开漏输出模式时，上方的 P-MOS 管完全不工作。如果我们控制输出为 0（低电平）时，则 P-MOS 管关闭，N-MOS 管导通，使输出接地，若控制输出为 1（无法直接输出高电平）时，则 P-MOS 管、N-MOS 管都关闭，所以引脚既不输出高电平，也不输出低电平，为高阻态。为正常使用 时必须外部接上拉电阻（例如传统 51 单片机的 P0 口），参考下图。它具有“线与”的特性，也就是说，若有很多个开漏模式的引脚连接到一起时，只有当所有的引脚都输出高阻态，才由上拉电阻提供高电平，此高电平的电压为外部上拉电阻所接的电源电压。若其中一个引脚为低电平，那线路就相当于短路接地，使得整条线路都为低电平（0V）。

推挽输出模式一般应用在输出电平为 0V 和 3.3V 而且需要高速切换开关状态的场合。在使用 STM32 的过程中，除了必须使用开漏输出模式的场合，我们基本上都是使用推挽输出模式。

开漏输出我们一般应用于 I2C、SMBUS 通讯等需要“线与”功能的场合。除此之外，还应用于电路电压不匹配的场合，如需要输出 5V 的高电平，就可以在外部接一个上拉电阻，上拉电源为 5V ，并且把 GPIO 设置为开漏输出模式，当输出高阻态时，由上拉电阻和电源向外输出 5V 的电平，具体见下图：

前面提到的双 MOS 管结构电路的输入信号，是由 GPIO“输出数据寄存器 GPIOx_ODR”提供的，因此我们通过修改输出数据寄存器的值就可以修改 GPIO 引脚的输出电平。而“置位/复位寄存器GPIOx_BSRR”可以通过修改输出数据寄存器的值从而影响电路的输出。

看 GPIO 结构框图的上半部分，GPIO 引脚经过内部的上、下拉电阻，可以配置成上/下拉输入，然后再连接到施密特触发器，信号经过触发器后，模拟信号转化为 0、1 的数字信号，然后存储在“输入数据寄存器 GPIOx_IDR”中，通过读取该寄存器就可以了解 GPIO 引脚的电平状态。

“复用功能输出”中的“复用”是指 STM32 的其它片上外设对 GPIO 引脚进行控制，此时 GPIO 引脚用作该外设功能的一部分，算作第二用途（例如传统 51 单片机的 P3_0、P3_1 引脚可以用来进行 UART 通信）。从其他外设引出来的“复位功能输出信号”与 GPIO 本身的数据寄存器都连接到双 MOS 管结构的输入中，通过梯形结构作为开关切换选择。

例如我们使用 USART 串口通讯，需要用到某个 GPIO 引脚作为通讯发送引脚，这个时候就可以把该 GPIO 引脚配置成 USART 串口复用功能，由该串口外设控制该引脚，发送数据。

当 GPIO 引脚用于 ADC 采集电压的输入通道时，用作“模拟输入”功能，此时信号是不经过施密特触发器的，因为经过施密特触发器后信号只有 0、1 两种状态，所以 ADC 外设要采集到原始的模拟信号，信号源输入必须在施密特触发器之前。类似地，当 GPIO 引脚用于 DAC 作为模拟电压输出通道时，此时作为“模拟输出”功能，DAC 的模拟信号输出就不经过双 MOS 管结构，模拟信号直接输出到引脚。

由上节可知，GPIO 的结构决定了 GPIO 可以配置成以下模式：

在固件库中，GPIO 总共有 8 种细分的工作模式，稍加整理可以大致归类为以下三类：

在输入模式时，施密特触发器打开，输出被禁止，可通过输入数据寄存器 GPIOx_IDR 读取 I/O 状态。其中输入模式，可设置为上拉、下拉、浮空和模拟输入四种。上拉和下拉输入很好理解，默认的电平由上拉或者下拉决定。浮空输入的电平是不确定的，完全由外部的输入决定，一般接按键的时候用的是这个模式。模拟输入则用于 ADC 采集。

在输出模式中，推挽模式时双 MOS 管以轮流方式工作，输出数据寄存器 GPIOx_ODR 可控制 I/O输出高低电平。开漏模式时，只有 N-MOS 管工作，输出数据寄存器可控制 I/O 输出高阻态或低电平。输出速度可配置，有 2MHz、10MHz、50MHz 的选项。此处的输出速度即 I/O 支持的高低电平状态最高切换频率，支持的频率越高，功耗越大，如果功耗要求不严格，把速度设置成最大即可。在输出模式时施密特触发器是打开的，即输入可用，通过输入数据寄存器 GPIOx_IDR 可读取 I/O的实际状态。

复用功能模式中，输出使能，输出速度可配置，可工作在开漏及推挽模式，但是输出信号源于其它外设，输出数据寄存器 GPIOx_ODR 无效；输入可用，通过输入数据寄存器可获取 I/O 实际状态，但一般直接用外设的寄存器来获取该数据信号。

通过对 GPIO 寄存器写入不同的参数，就可以改变 GPIO 的工作模式，要了解具体寄存器时一定要查阅 《STM32F10X-中文参考手册》 中对应外设的寄存器说明。在 GPIO 外设中，控制端口高低控制寄存器 CRH 和 CRL 可以配置每个 GPIO 的工作模式和工作的速度，每 4 个位控制一个 IO，CRH 控制端口的高八位，CRL 控制端口的低 8 位，具体的看 CRH 和 CRL 的寄存器描述。

每个 I/O 端口可以自由编程，但 I/O 端口寄存器必须按 32 位被访问。 STM32 的很多 I/O 端口都兼容 5V 的，这些 I/O 端口在与 5V 电压的外设连接时很有优势，具体哪些 I/O 端口是兼容 5V 的，可以从芯片的数据手册引脚描述章节查到。

STM32 的每个 I/O 端口都有 7 个寄存器来控制。常用的 I/O 端口寄存器只有 4 个，分别为 CRL、CRH、IDR、ODR。CRL 和 CRH 控制着每个 I/O 端口的模式及输出速率。STM32 的端口配置表如下图所示：

端口配置低寄存器（GPIOx_CRL）(x = A…E)，如下图所示： 配置方法：

端口配置高寄存器(GPIOx_CRH) (x=A…E)，如下图所示： 配置方法： 例如，使用 GPIOA 控制的是一个 Led 灯，可以选择通用推挽输出，设置速度为 10MHz，实现代码为：

端口输入数据寄存器(GPIOx_IDR) (x=A…E)，如下图所示： 配置方法：

端口输出数据寄存器(GPIOx_ODR) (x=A…E)，如下图所示： 配置方法： 例如：

在本文中 STM32 芯片与 LED 灯的连接见下图：

这是一个 RGB 灯，里面由红蓝绿三个小灯构成，使用 PWM 控制时可以混合成 256 不同的颜色。

图中从 3 个 LED 灯的阳极引出连接到 3.3V 电源，阴极各经过 1 个限流电阻引入至 STM32 的 3 个GPIO 引脚中，所以我们只要控制这三个引脚输出高低电平，即可控制其所连接 LED 灯的亮灭。如果您的实验板 STM32 连接到 LED 灯的引脚或极性不一样，只需要修改程序到对应的 GPIO 引脚即可，工作原理都是一样的。

我们的目标是把 GPIO 的引脚设置成推挽输出模式并且默认下拉，输出低电平，这样就能让 LED灯亮起来了。

名为“startup_stm32f10x_hd.s”的文件，它里边使用汇编语言写好了基本程序，当 STM32 芯片上电启动的时候，首先会执行这里的汇编程序，从而建立起 C 语言的运行环境，所以我们把这个文件称为启动文件。该文件使用的汇编指令是 Cortex-M3 内核支持的指令，可参考 《Cortex-M3 权威指南》 中指令集章节。

startup_stm32f10x_hd.s 文件由官方提供，一般有需要也是在官方的基础上修改，不会自己完全重写。该文件从 ST 固件库里面找到，找到该文件后把启动文件添加到工程里面即可。不同型号的芯片以及不同编译环境下使用的汇编文件是不一样的，但功能相同。

其功能如下：

开头的是程序注释，在汇编里面注释用的是“;”，相当于 C 语言的“//”注释符

第二行是定义了一个子程序：Reset_Handler。PROC 是子程序定义伪指令。这里就相当于 C 语言里定义了一个函数，函数名为 Reset_Handler。

第三行 EXPORT 表示 Reset_Handler 这个子程序可供其他模块调用。相当于 C 语言的函数声明。关键字 [WEAK] 表示弱定义，如果编译器发现在别处定义了同名的函数，则在链接时用别处的地址进行链接，如果其它地方没有定义，编译器也不报错，以此处地址进行链接。

第四行和第五行 IMPORT 说明 SystemInit 和 __main 这两个标号在其他文件，在链接的时候需要到其他文件去寻找。相当于 C 语言中，从其它文件引入函数声明。以便下面对外部函数进行调用。

SystemInit 需要由我们自己实现，即我们要编写一个具有该名称的函数，用来初始化 STM32 芯片的时钟，一般包括初始化 AHB、APB 等各总线的时钟，需要经过一系列的配置 STM32 才能达到稳定运行的状态。其实这个函数在固件库里面有提供，官方已经为我们写好。

__main 其实不是我们定义的 (不要与 C 语言中的 main 函数混淆)，这是一个 C 库函数，当编译器编译时，只要遇到这个标号就会定义这个函数，该函数的主要功能是：负责初始化栈、堆，配置系统环境，并在函数的最后调用用户编写的 main 函数，从此来到 C 的世界。

第六行把 SystemInit 的地址加载到寄存器 R0。

第七行程序跳转到 R0 中的地址执行程序，即执行 SystemInit 函数的内容。

第八行把 __main 的地址加载到寄存器 R0。

第九行程序跳转到 R0 中的地址执行程序，即执行 __main 函数，执行完毕之后就去到我们熟知的 C 世界，进入 main 函数。

第十行表示子程序的结束。

总之，看完这段代码后，了解到如下内容即可：我们需要在外部定义一个 SystemInit 函数设置 STM32 的时钟；STM32 上电后，会执行 SystemInit 函数，最后执行我们 C 语言中的 main 函数。

看完启动文件，那我们立即写 SystemInit 和 main 函数吧？别着急，定义好了 SystemInit 函数和 main 我们又能写什么内容？连接 LED 灯的 GPIO 引脚，是要通过读写寄存器来控制的，就这样空着手，如何控制寄存器。我们知道寄存器就是给一个已经分配好地址的特殊的内存空间取的一个别名，这个特殊的内存空间可以通过指针来操作。在编程之前我们要先实现寄存器映射，有关寄存器映射的代码都统一写在 stm32f10x.h 文件中。

代码的最后两段是 RCC 外设寄存器的地址定义，RCC 外设是用来设置时钟的，本实验中只要了解到使用 GPIO 外设必须开启它的时钟即可。

现在就可以开始编写程序，在 main 文件中先编写一个 main 函数，里面什么都没有，暂时为空。

此时直接编译的话，会出现如下错误： Error: L6218E: Undefined symbol SystemInit (referred from startup_stm32f10x.o)

错误提示 SystemInit 没有定义。从分析启动文件时我们知道，Reset_Handler 调用了该函数用来始化 SMT32 系统时钟，为了简单起见，我们在 main 文件里面定义一个 SystemInit 空函数，什么也不做，为的是骗过编译器，把这个错误去掉。关于配置系统时钟我们在后面再写。当我们不配置系统时钟时，STM32 会把 HSI 当作系统时钟，HSI=8M，由芯片内部的振荡器提供。我们在main 中添加如下函数：

首先我们把连接到 LED 灯的 GPIO 引脚 PB0 配置成输出模式，即配置 GPIO 的端口配置低寄存器 CRL，见图： GPIO 端口控制低寄存器 CRL 。

CRL 中包含 0-7 号引脚，每个引脚占用 4 个寄存器位。MODE 位用来配置输出的速度，CNF 位用来配置各种输入输出模式。在这里我们把 PB0 配置为通用推挽输出，输出的速度为 10M。

整个函数与“构建库函数雏形”章节中的类似，主要区别是硬件相关的部分使用宏来代替，初始化 GPIO 端口时钟时也采用了 STM32 库函数，函数执行流程如下：

使用 GPIO_InitTypeDef 定义 GPIO 初始化结构体变量，以便下面用于存储 GPIO 配置。

调用库函数 RCC_APB2PeriphClockCmd 来使能 LED 灯的 GPIO 端口时钟，在前面的章节中我们是直接向 RCC 寄存器赋值来使能时钟的，不如这样直观。该函数有两个输入参数，第一个参数用于指示要配置的时钟，如本例中的“RCC_APB2Periph_GPIOB”；函数的第二个参数用于设置状态，可输入“Disable”关闭或“Enable”使能时钟。

向 GPIO 初始化结构体赋值，把引脚初始化成推挽输出模式，其中的 GPIO_Pin 使用宏“LEDx_GPIO_PIN”来赋值，使函数的实现方便移植。

使用以上初始化结构体的配置，调用 GPIO_Init 函数向寄存器写入参数，完成 GPIO 的初始化，这里的 GPIO 端口使用“LEDx_GPIO_PORT”宏来赋值，也是为了程序移植方便。

使用同样的初始化结构体，只修改控制的引脚和端口，初始化其它 LED 灯使用的 GPIO 引脚。

在 main 函数中，调用我们前面定义的 LED_GPIO_Config 初始化好 LED 的控制引脚，然后直接调用各种控制 LED 灯亮灭的函数来实现 LED 灯的控制。

以上，就是一个使用 STM32 标准软件库开发应用的流程。